home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / rm.lha / rm.doc next >
Encoding:
Text File  |  1994-07-10  |  4.2 KB  |  136 lines
  1.                             rm by Omar Siddique
  2.                            for the Amiga computer
  3.                                July 8, 1994
  4.  
  5. WHAT IS RM AND WHAT GOOD IS IT?
  6.  
  7.    Rm is a replacement for the AmigaDOS "delete" command.  Rm has a standard
  8. query delete mode in which the program prompts the user for confirmation
  9. of deletion per file.  Rm also has UNIX-like command line options that bypass
  10. this, and understands * wildcards.
  11.  
  12.    My purpose in writing rm was to create a delete command that would
  13. require confirmation of deletion so I wouldn't keep erasing files by accident.
  14. I also wanted something closer in appearance and usage to the UNIX rm
  15. command I use at work and school.
  16.  
  17.  
  18. HOW TO USE RM
  19.  
  20.    Rm is simple to use.  Simply place it in the appropriate location on
  21. your path.  To use rm in its standard mode:
  22.  
  23. rm [file1] [file2] [file...]
  24.  
  25.  
  26. COMMAND LINE OPTIONS
  27.  
  28. h    -- Display a brief help message.
  29.  
  30. f    -- Delete protected files.
  31.  
  32. n       -- No query, don't ask for permission before deletion.
  33.  
  34. r    -- Delete files recursively.  This will delete any directories
  35.            specified, along with all of their contents, *including*
  36.            sub-directories.
  37.  
  38. Options must be the first argument on the command line, and must be
  39. preceded by a dash.
  40.  
  41. Correct:     rm -rf booga
  42. Incorrect:   rm booga -rf
  43.  
  44. The order of the options doesn't matter; rm treats -rn the same as -nr.
  45.  
  46. So, to delete all files in sys: except protected ones, without
  47. confirmation, you would type:
  48.  
  49. rm -rn sys:*
  50.  
  51. To delete files called "junk" and "morejunk", with confirmation of deletion:
  52.  
  53. rm junk morejunk
  54.  
  55.  
  56. FURTHER USAGE NOTES
  57.  
  58.    Be careful in using rm -rfn -- it *will* delete whatever files/directories
  59. you ask it to delete, as well as any contained subdirectories and their
  60. contents, without prompts.
  61.  
  62.    Rm understands both standard and Amiga wildcards (?, *, #?).
  63.  
  64.    Rm is pure, and the AmigaDOS "resident" command can be used on it.
  65.  
  66.    C: is a good place to keep rm, or use rm to replace your delete command.
  67. Alternately, alias "delete" to "rm".  If a certain set of command line
  68. options is must useful to you, alias it to rm.  (e.g., alias rm rm -n)
  69.  
  70.  
  71. COMPATIBILITY, BUGS, AND LIMITATIONS
  72.  
  73.    Rm was compiled with SAS/C 6.51 and tested on an Amiga 3000/25 with
  74. 5 megs of RAM, KickStart 2.04, and Workbench 2.1.  It should run properly on
  75. any Amiga.  If there are any compatibility problems, let me know.
  76.  
  77.    There are no known bugs.  
  78.  
  79.    Rm's only limitation is its size (quite a bit more than the AmigaDOS
  80. delete command).  This will be somewhat alleviated when SAS/C 6.52 comes
  81. out, since extra code was necessary to work around a bug in SAS's getfnl().
  82.  
  83.  
  84. CONTACTING THE AUTHOR
  85.  
  86.    Feel free to send any comments, question, complaints, flames, bug-reports,
  87. requests, suggestions, and whatever else to me at:
  88.  
  89.    Internet: osiddi1@umbc.edu    (try here first)
  90.              o.siddique2@genie.geis.com
  91.       GEnie: O.Siddique2
  92.  
  93.    Or if you prefer to use slower means (or wish to send presents, money, 
  94. pictures of youself, a new 2 gig drive, etc):
  95.  
  96.  Snail Mail: Omar Siddique
  97.              P.O. Box 451
  98.              Perry Hall, MD  21128
  99.  
  100.  
  101. DISTRIBUTION AND DISCLAIMER
  102.  
  103.    Rm is freely distributable.  However, it must be distributed in
  104. its intact, original archive, which includes this document and the
  105. executable.
  106.  
  107.    While rm has proven stable and problem free, the standard disclaimer
  108. applies; this program should work just fine, be harmless entertainment, and so
  109. forth, but if it causes your computer to achieve sentience and take over the
  110. world, randomly deletes paragraphs from the novel you've been working on
  111. for five years, or causes any other unexpected evilness, the author is
  112. not responsible or liable for any damage or claims that result. :-)
  113.  
  114.  
  115. OTHER FINE AMIGA WORKS BY THE AUTHOR
  116.  
  117.    QuoteGiver -- Displays quotes and sayings randomly from a list
  118.  
  119.    Free       -- Displays free space available on a drive
  120.  
  121.    Purity     -- Purity test taker
  122.  
  123.  
  124. ABOUT THE AUTHOR
  125.  
  126.    I'm an undergraduate Computer Science major/History minor at University
  127. of Maryland, Baltimore County campus.  I seem to spend all of my time around
  128. computers, but I occasionally find time to eat, sleep, dig holes in the
  129. ground, etc.  To contact me, see above.
  130.  
  131.  
  132. VERSION NOTES
  133.  
  134. 1.00    Initial Release
  135.  
  136.